package com.dkd.manage.mapper;

import java.util.List;
import com.dkd.manage.domain.Channel;
import com.dkd.manage.domain.vo.ChannelVo;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

/**
 * 售货机货道Mapper接口
 * 
 * @author lxs
 * @date 2024-11-16
 */
public interface ChannelMapper 
{
    /**
     * 查询售货机货道
     * 
     * @param id 售货机货道主键
     * @return 售货机货道
     */
    public Channel selectChannelById(Long id);

    /**
     * 查询售货机货道列表
     * 
     * @param channel 售货机货道
     * @return 售货机货道集合
     */
    public List<Channel> selectChannelList(Channel channel);

    /**
     * 新增售货机货道
     * 
     * @param channel 售货机货道
     * @return 结果
     */
    public int insertChannel(Channel channel);

    /**
     * 修改售货机货道
     * 
     * @param channel 售货机货道
     * @return 结果
     */
    public int updateChannel(Channel channel);

    /**
     * 删除售货机货道
     * 
     * @param id 售货机货道主键
     * @return 结果
     */
    public int deleteChannelById(Long id);

    /**
     * 批量删除售货机货道
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteChannelByIds(Long[] ids);

    /**
     * 批量插入频道信息
     *
     * @param channelList 频道对象列表，用于批量插入
     * @return 返回插入操作的影响行数
     */
    public int insertChannels(List<Channel> channelList);
    /**
     * 根据SKU ID数组统计渠道数量
     * 此方法用于查询与给定SKU ID数组相关的渠道数量它可以帮助了解特定商品SKU的渠道分布情况
     *
     * @param skuIds SKU ID数组，用于查询渠道信息
     * @return 返回与SKU ID数组相关的渠道数量
     */
    int countChannelBySkuIds(Long[] skuIds);

    /**
     * 根据货道编号查询货道列表
     *
     * @param innerCode 货道编号，用于唯一标识一个渠道
     * @return 返回ChannelVo列表，包含所有匹配的渠道信息如果找不到匹配的渠道，返回空列表
     */
    List<ChannelVo> selectChannelVoByInnerCode(String innerCode);


    /**
     * 根据售货机编号和货道编号
     * 此方法使用MyBatis的@Select注解来执行SQL查询，以获取符合条件的渠道记录
     * 选择此方法的原因是，它需要根据两个不同的条件（内部代码和渠道代码）来查询数据库，
     * 并且这两个条件都是通过参数传递给SQL语句的
     *
     * @param innerCode 内部代码，用于定位特定的渠道记录 不能为空
     * @param channelCode 渠道代码，用于进一步限定查询结果 不能为空
     * @return 返回查询到的货道信息对象（Channel） 如果没有找到匹配的记录，返回null
     */
    @Select("select * from tb_channel where inner_code = #{innerCode} and channel_code = #{channelCode}")
    Channel getChannelInfo(@Param("innerCode")String innerCode,@Param("channelCode") String channelCode);


    /**
     * 批量更新售货机货道信息
     * @param channelList
     * @return
     */
    int batchUpdateChannels(List<Channel> channelList);

    /**
     * 批量更新售货机货道信息
     * @param channelList
     * @return
     */
    int batchUpdateChannel(List<Channel> channelList);



}
